[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 FT_RESTATT()
 Restore the attribute bytes of a specified screen region.
------------------------------------------------------------------------------

 Syntax

     FT_RESTATT( <nTop>, <nLeft>, <nBottom>, <nRight>, <cAttributes> ) -> NIL

 Arguments

    <nTop>, <nLeft>, <nBottom>, and <nRight> define the screen region.
    <cAttributes> is a character string containing the attribute bytes
                  for the screen region.  This will most often be a string
                  previously returned by FT_SAVEATT(), but any character
                  string may be used (provided it is of the proper size).

 Returns

    NIL

 Description

    This function is similar to Clipper's RestScreen(), except that it only
    restores the attribute bytes.  This is useful if you want to change the
    screen color without affecting the text.

    *** INTERNALS ALERT ***

    This function calls the Clipper internals __gtSave and __gtRest to
    manipulate the the screen image.  If you're too gutless to use
    internals, then this function isn't for you.

 Examples

    // Restore attributes of row 4
    FT_RESTATT( 4, 0, 4, maxcol(), cBuffer)

    // Restore attributes to middle of screen
    FT_RESTATT(10,20,14,59,cBuffer)

 Source: RESTATT.ASM

 Author: Ted Means

See Also: FT_SAVEATT()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson